home *** CD-ROM | disk | FTP | other *** search
/ 1,000+ Great Games / 1_1000 Games.iso / FAQS / GG2_AUG.ZIP / WSQL.ZIP / README / README.1ST
Encoding:
Text File  |  1994-04-15  |  6.5 KB  |  185 lines
  1.            WATCOM SQL Version 3.2d
  2.        =======================
  3.              Read Me First
  4.          =============
  5.  
  6. If you have any problems with this software, please
  7. contact:
  8.            WATCOM 
  9.        415 Phillip St.
  10.        Waterloo, ON
  11.        CANADA
  12.        N2L 3X2
  13.  
  14.        Telephone:  (519) 886-3700
  15.        FAX:        (519) 747-4971
  16.        BBS:        (519) 884-2103
  17.  
  18.  
  19. Online Manuals
  20. ==============
  21.  
  22. 1. The Windows, DOS and OS/2 help files have been enhanced to be
  23.    full online manuals.  All of the Database Interface sections from
  24.    the printed manual are now in the online manual.  
  25.    
  26.   
  27. Diskette Counts
  28. ===============
  29.  
  30. 1. Increasing the size of the help files as mentioned above has had the
  31.    side effect of increasing the diskette count on some of the software
  32.    beyond what is documented in the printed READ ME FIRST booklets.
  33.    The Windows and OS/2 clients are now on two diskettes.
  34.  
  35.  
  36. Database Engine
  37. ===============
  38.  
  39. 1. There is a new command to extend the size of the main database file
  40.    or an extra dbspace:
  41.    
  42.          ALTER DBSPACE name ADD number
  43.     
  44.    where name is the dbspace name and number is the number of pages to
  45.    add to the file.  Dbspace names can be found in the SYSFILE system
  46.    table.
  47.    
  48.    This allows these files to be extended in large amounts before the
  49.    space is required rather than the normal 32 pages at a time when
  50.    the space is needed.  This can improve performance for loading
  51.    large amounts of data and also serves to keep the dbspace files
  52.    more contiguous within the file system.
  53.    
  54. 2. The term "cursor stability" means that any row that is the current
  55.    position of a cursor will not be modified until the cursor leaves
  56.    the row, and, that a cursor will block trying to read a row that
  57.    has been modified by another transaction but not committed.  
  58.    WATCOM SQL has always provided cursor stability at isolation levels
  59.    2 and 3.  (This is actually inherent in the definition of isolation
  60.    levels 2 and 3).  The WATCOM SQL NLM for NetWare version 3.2d
  61.    and version 3.2e of all other engines provide cursor stability 
  62.    automatically at isolation level 1.
  63.    
  64.  
  65. NLM Database Server
  66. ===================
  67.  
  68. 1. You should install client software on the adminstration
  69.    workstation.  This will allow access to the NLM server from
  70.    the administration machine as well as providing the Interactive SQL tool.
  71.    Choose either the DOS Client or the Windows Client. 
  72.    
  73. 2. It is now possible (version 3.2d) to build NetWare NLMs that access
  74.    the database using Embedded SQL.  This can be done with WATCOM SQL for
  75.    DOS version 3.2d.  The preprocessor command is:
  76.       
  77.           sqlpp -o NETWARE <filename>
  78.       
  79.    The library c:\wsql\lib\dblibwsn.lib is used to link an NLM with the
  80.    WATCOM compiler and tools.  c:\wsql\dblibwsn.imp is an import command
  81.    file to use at link time.
  82.    
  83.    There is a new batch file: c:\wsql\ppxmp\mkwcnlm.bat.  This batch
  84.    file will build the embedded SQL example programs into NLMs:
  85.             
  86.       mkwcnlm cursex
  87.       
  88.    See this batch file for details as to how to compile and link
  89.    NLMs that access WATCOM SQL.  The 32-bit WATCOM C/C++ compiler
  90.    is required -- version 9.5 or 10.0.
  91.  
  92.  
  93.  
  94. DOS and Windows Client Disks
  95. ============================
  96.  
  97. 1. DBINFO.EXE
  98.    In the some of the early Read Me First booklets, the file DBINFO.EXE
  99.    is documented as being a component of the DOS and Windows Clients.
  100.    This is not the case. DBINFO is installed as an adminstration tool.  
  101.    DBINFO will not run against the network server.
  102.  
  103.  
  104.  
  105. DOS Database Engine
  106. ===================
  107.  
  108. 1. DOS16M environment variable:
  109.    DB32 and RT32 use the rational DOS extender (DOS4G/DOS16M).  In environments
  110.    where there is no extended memory manager, DOS16M will use all memory
  111.    for the DOS extender even if the database engine doesn't use it all.
  112.    In this case the DB32 switch -c nnnK will not help.
  113.  
  114.    To alleviate this problem, set the DOS16M environment variable to specify
  115.    how much memory the DOS extender should use.
  116.  
  117.        set DOS16M= [@start_address [- end_address]] [:size]
  118.  
  119.    Examples:
  120.        1. set DOS16M=@2M-4M
  121.  
  122.           - use extended memory between 2.0M and 4.0M physical memory.
  123.  
  124.        2. set DOS16M=:3M
  125.  
  126.           - use upto 3M of extended memory.
  127.  
  128.  
  129.  
  130. WATCOM SQL Runtime System for DOS
  131. =================================
  132.  
  133. 1. Two files were not mentioned in the printed "Read Me First".  RTACME.EXE
  134.    and RTACME32.EXE are on the diskettes.  Note that because of these two
  135.    new files, there are now 2 diskettes for the Runtime System for DOS.
  136.  
  137.  
  138. DOS Applications with WATCOM SQL for OS/2
  139. =========================================
  140.  
  141. 1. WATCOM SQL for OS/2 provides the appropriate DOS client
  142.    software to access the OS/2 database engine from an OS/2 DOS Box.
  143.    However, the install runs under OS/2 Presentation Manager and
  144.    does not modify any of the DOS Box setup required to run the software.
  145.    The following manual step is required to run DOS software:
  146.       a) Modify the path for the DOS Box to include the
  147.          c:\wsql directory (or whereever you installed WATCOM SQL for OS/2).
  148.  
  149.  
  150. Win/OS2 Applications with WATCOM SQL for OS/2
  151. =============================================
  152.  
  153. 1. WATCOM SQL for OS/2 provides the appropriate Windows client
  154.    software to access the OS/2 database engine from Win/OS2.  However,
  155.    the install runs under OS/2 Presentation Manager and does not modify
  156.    any of the Windows setup required to run the software under
  157.    Win/OS2.  The following manual steps are required to run Win/OS2
  158.    software:
  159.       a) Modify the path for the WinOS2 session to include the
  160.          c:\wsql directory (or whereever you installed WATCOM SQL for OS/2).
  161.  
  162.       b) Create the following Program Manager Icons in a group called
  163.          WATCOM SQL:
  164.  
  165.      Description           Exe            Parameters    Working Directory
  166.      -----------           ---            ----------    -----------------
  167.      Database Client       dbclienw.exe   sample        c:\wsql
  168.      ISQL               isqlw.exe                    c:\wsql
  169.      ODBC Administrator    odbcadm.exe                  c:\wsql
  170.      DDE Server            wsqldde.exe                  c:\wsql
  171.  
  172.       c) If you wish to use the ODBC driver, add the following lines to
  173.          the ODBC.INI file in you Win/OS2 directory.  You can then
  174.      use the ODBC Administrator to create a data source.
  175.  
  176.      [ODBC Drivers]
  177.      WATCOM SQL=Installed
  178.     
  179.      [WATCOM SQL]
  180.      driver=c:\wsql\wsqlodbc.dll
  181.      setup=c:\wsql\wsqlodbc.dll
  182.  
  183.  
  184.  
  185.